CallObjectAccessor

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallObjectAccessor
The CallObjectAccessor method resolves the object specifier into a target and returns a reference to an OpenDoc token identifying that target.
void CallObjectAccessor (in ODPart thePart,
                         in ODDescType desiredClass, 
                         in ODOSLToken container,
                         in ODDescType containerClass, 
                         in ODDescType form, 
                         in ODDesc selectionData, 
                         in ODOSLToken value);
thePart
A reference to the part associated with this semantic interface object.
desiredClass
The class of the desired Apple event objects.
container
A reference to an OpenDoc token identifying the container for the desired objects.
containerClass
The class of the container for the desired Apple event objects.
form
The key form specified by the object specifier record for the object or objects to be located.
selectionData
A reference to a descriptor object with the key data specified by the object specifier record for the object or objects to be located.
value
A reference to an OpenDoc token to be filled in by the object accessor being called.

DISCUSSION
OpenDoc calls this method in response to a call to the name resolver's Resolve method. Your override of this method should be able to resolve any of the object types supported by your part.
Use the desiredClass and containerClass parameters to identify the appropriate handler.
If your part cannot resolve an object specifier, but one of your embedded parts may be able to, your override of this method can set the value parameter to be equivalent to the swap token obtained from the name resolver's CreateSwapToken method. This is important for parts that support embedding, since your part's semantic interface must allow embedded parts to resolve objects that they know about.

EXCEPTIONS
The Apple Event Manager may throw an exception if this method is unable to resolve the specified object.
This method may throw platform-specific exceptions.

SEE ALSO
The ODDescType type (page 925).
The ODNameResolver::CreateSwapToken method (page 422).
The ODNameResolver::Resolve method (page 426).
The ODDesc class (page 104).
The ODOSLToken class (page 456).
For more information on resolving object specifiers, see the "Resolving and Creating Object Specifier Records" chapter of Inside Macintosh: Interapplication Communication.